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ABSTRACT 



A record layout in a legacy application is defined by the 
record definition in the source code of the language in which 
the application was written. For each record in a legacy 
application, the layout of the record is saved in a language- 
neutral and architecture neutral format in preparation for a 
runtime invocation. During runtime, for each record, the 
legacy application can send architecture-specific binary 
information as it exists in memory on the legacy computer 
to a component runtime environment that will construct a 
compatible object-oriented instance of a class to manipulate 
the information. Once the information is manipulated, the 
updated information can be represented to the original 
legacy application in an architecture-specific binary record 
layout. 
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<?xmi version» ,, l . 0"?> 

<tDOCTYPE record SYSTEM "/XML/Meta/tmeta .dtd"> 

<record name=" STUDENT- SUMMARY- INFORMATION" archi tecture="s390" align*="l"> 
<field type= tt pic" aligrv="l n spec~»999999" size«»6"> 

<name>ID-NUMBER</name> 

Ossoci ation>I D-NUMBER</ associ ation> 
</field> 

<fieid type^'pic" align="l" spec="999999" Bize="6"> 

<name>PIN</name> 

Ossoci ation>PIN</ ass ociation> 
</field> 

<field type="pic" align="l" spec="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" size="35 tt > 

<name>NAME</name> 

Ossoci ation>NAME</as soci ati on> 
</field> 

<array size*»"3"> 

<name>ADDRESS</name> 

Ossoci at ion> ADDRESS </ associ at ion> 

<field type="pic" align- "1" spec= ,, XXXXXXXXXXXXXXXXXXXXXXXXX" size«"25"> 

<name>ADDRESS</ name> 

Ossociation>ADDRESS</association> 
</field> 
</array> 

<field type* n pic" align^'l" spec=» 999X999X9999" size="12"> 

<n a me> PHONE -NUMBER</ name> 

Ossoci at ion>PHONE-NUMBER</association> 
</field> 

<field type-"pic" align="l" 6pec="999X99X9999" si2e="ll"> 

<name>SOCIAL- SECURITY -NUMBER</name> 

Ossoci ation>SOCIAL- SECURITY -NUMBER</association> 
</field> 

afield type^-pic" align= ,, l w spec«"999" shift*"-?" size="3"> 

<name>GRADE-POINT-AVERAGE</name> 

Ossoci at ion>GRADE-POINT-AVERAGE</ associ at a on> 
</field> 
<struct> 

<name>BALANCES</name> 

Ossoci a tion>BALANCES</assoclation> 

<field type* "pa eked" align*"l" size«"3"> 
<name>TUITION</name> 
<association>TUITION</association> 

</field> 

<field type="packed" aligns"! 1 ' size«="3"> 
<name>HOUSING</ name> 



<association>HOUSING</ associ a tion> 
</field> 
</struct> 
</record> 
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package com. touchnet .beangen; 

import com. touchnet .base , * ; 
import java.io,*; 
import ^ava.util.*; 



* This will provide the functionality that is common to all generated JavaBeans that 

* map into legacy structures 
* 

* Creation date: (12/14/99 1:28:08 PM) 

* ^author: Gary Murphy 
*/ 

public abstract class AbstractStructure 
implements Structurelnterf ace 

< 

private String architecture; 
private StructTreeNode root = null; 

private BinaryRenderingEngine engine = new BinaryRenderingEngine () ; 
private 3 ava . lang . String metadataName; 

/** 

* Create the base constructure for Java objects that wrapper legacy data 

* structures 
*/ 

public AbstractStructure ( J 
{ 

super ( ) ; 
} 

/** 

* Access the name of the architecture that the underlying binary data 

* represents 
V 

public String getArchitecture ( ) 
throws TException 
i 

return architecture; 
} 

/** 

* This will access an array within the structure. It will be returned as 

* an array of some concrete instance of this AbstractStructure. Even if 

* the array is of a single field, it will still be represented as a 

* structure that simply contains a single element. If the requested 

* element is not an array, this will throw an exception 
*/ 

public Structurelnterf ace U getArray (String name) 
throws TException 
I 

AbstractStructureTreeNode node «* getNode ( name) ; 
if (node instanceof ArrayTreeNode ) 
( 

ArrayTreeNode arrayNode « (ArrayTreeNode ) node; 
return arrayNode. getArray () ; 

) 

// If this isn't an array node, then we tried to access a non-array 
// as an array 

throw new TExceptlon ( "Attempt to access a non-array element as an array"}; 

} 

/** 

* Access the binary rendering engine. 



* Creation date: (1/3/00 1:11:03 PM) 

* Greturn com. touchnet .base .BinaryRenderingEngine 

*/ 

protected BinaryRenderingEngine getEngine( ) 
( 

if (null == engine) 

engine - new BinaryRenderingEngine () ; 
return engine; 
) 



Fig. 4B 
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+ Access the named field within the component 
*/ 

public String getField (String name) 
throws TException 
i 

AbstractStructureTreeNode node getNode (name J ; 
if (node instanceof FieldTreeNode) 
{ 

FieldTreeNode fieldNode = (FieldTreeNode) node- 
return f ieldNode. get Field ( ) .toStrmgO ; 
) 

// It's not a field, so this is an exception 

throw new TExcepti on ("Attempt to access a non-field element as a field"); 
) 

/** 

* Access the name of the metadata that describes this component 

* Creation date: (2/29/00 11:24:5B AM) 

* ©return j ava . lang . String 
*/ 

public String getMetadataName ( ) 

< 

return metadataName; 

} 

/** 

* This will access the named node, starting at the root of the embedded tree 

* Creation date: (2/29/00 11:43:09 AM) 

* Sreturn com. touchnet .beangen. AbstractStructureTreeNode 

* @param name j ava . lang. String 

* Sexception com. touchnet .base. TException The exception description. 
*/ 

protected AbstractStructureTreeNode getNode (String name) 
throws TException 

StringTokenizer tokenizer = new StringTokenizer (name, "/"); 

return getNode (tokenizer, getRoot()); 

) 

/** 

* This will access the named node, as a child of the current node. The name 

* is the next element in the tokemzei . If the name child doesn't exist, this 

* will throw an exception 
* 

* Creation date: (2/29/00 11:43:09 AM) 

* Greturn com. touchnet .beangen. AbstractStructureTreeNode 

* Gparam name 3 ava. lang. St ring 

* Gexception com. touchnet . base .TException The exception description. 
*/ 

protected AbstractStructureTreeNode 

getNode (StringTokenizer tokenizer, AbstractStructureTreeNode current) 
throws TException 

i 

if ( ! tokenizer . hasMoreElements ( ) ) 

return current; // The current node is the requested noae 

String child = tokeni zer .nextToken [ ) ; 

// Look tor the name among the child node? 

mt count - current . getChildCount () ; 
for tint 1=0; i < count; ++i) 
{ 

AbstractStructureTreeNode node = 

(AbstractStructureTreeNode ) current .getChildAt (i ) ; 
if (node .getNamel ) . equals (child) ) 

return getNode( tokenizer, node); 

) 



Fig. AC 
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// The name didn't match any of the children 

throw new TException ( "The child of • "+current . getName ( ) 4 " » named 

child-*" ' does not exist"]; 

I 

. /*• 

* This will access the root node for the legacy data layout 

* Creation date: (1/3/00 12:56:46 PM) 

+ @return com. touchnet .beangen. StructTreeNode 
*/ 

protected StructTreeNode getRoot ( ) 
{ 

return root; 

} 

/** 

* This will read the binary contents of the input stream anc 

* place it in the appropriate nodes of the tree 
V 

public void read (InputStream stream) 
throws TException 
{ 

// Code not shown 
) 

/** 

* Access the name of the architecture that describes the underlying 

* binary data. 
*/ 

public void setArchitecture (String name) 
throws TException 
i 

architecture «= name; 
return; 

} 

/** 

* Set the array for this level in the data structure 
*/ 

public void setArraytString name, Structurelnterf ace [ ] child) 
throws TException 
{ 

AbstractStructureTreeNode node - getNode (name ) ; 
if (node instanceof ArrayTreeNode ) 

{ 

ArrayTreeNode arrayNode - (ArrayTreeNode )noae; 

arrayNode. setArray (child ) ; 

} 

// If this isn't an array node, then we tried to access a non-array 
// as an array 

throw new TExcepti on ( " Attempt to access a non-array element as an array" ); 
} 

/*» 

+ Update the named field with the value 
*/ 

public void setField (String name, String value) 
throws TException 

{ 

AbstractStructureTreeNode node « getNode (name ) ; 
if (node instanceof Fi eldTreeNode ) 

{ 

FieldTreeNode fieldNode = (FieldTreeNode) noae; 
LegacyField field - f leldNode . get Fi eld ( ) ; 
field. setValue (value) ; 
) 

// It's not a field, so this ie an exception 
throw new TException ("Attempt to access a non-field element as a field"); 



Fig. 4D 
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) 

/** 

* Access the name of the metadata that describes this component 
* 

* Creation date: (2/29/00 11:24:58 AM) 

* Gparam name java . lang . String 

public void setMetadataName (String name) 
{ 

metadataName - name; 

return; 

} 



* This will access the root node for the legacy data layout 

* Creation date: (1/3/00 12:56:48 PM) 

* €param rootNode com. touchnet . beangen, StructTreeNode 



protected void setRoot { StructTreeNode rootNode) 
{ 

root = rootNode ; 

return; 

) 

/** 

* This will write the binary contents back to the 
*/ 

public void write (Output Stream stream) 
throws TException 
{ 

// Code not shown 
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package corn . touchnet . beangen .generated; 

import com. touchnet .beangen.* ; 
import com. touchnet .base . * ; 
/** 

♦ This was automatically generated 2/29/00 12:38:47 PM 
*/ 

public class Student Summarylnf ormat ion 
extends Abst ractStructure 

t 

* StudentSumroarylnformation constructor comment. 
*/ 

public StudentSummarylnf ormationt ) { 
super ( ) ; 

) 

public String getAddress ( int index) 
throws TException 

Structurelntertacel) array = getArrayt "/ADDRESS" ) ; 

return array [index] .getField (V } ; 

} 

public String getGradePointAverage ( ) 
throws TException 
{ 

return getField {"/GRADE -POl NT-AVERAGE" ) ; 
) 

public String getHousingU 
throws TException 
{ 

return getField ("/BALANCES /HOUSING" ) ; 
1 

public String getldNumber ( ) 
throws TException 
( 

return getField ( "/ID-NUMBER" ) ; 
) 

public String getNameO 
throws TException 

{ 

return getField ( "/NAME" ) ; 
} 

public String get PhoneNumber ( ) 
throws TException 
{ 

return get Field (V PHONE-NUMBER" ) ; 

} 

public String getPINO 
throws TException 
{ 

return get Field ("/ PIN" ) ; 
) 

public String getSocialSecurityNumber { ) 
throws TException 

( 

return getField ( "/SOCIAL-SECURITY-NUMBER" ) ; 

i 

public String getTuitiont) 
throws TException 

{ 

return aet Field ( "/BALANCES/ TUITION" J ; 

} 

public void setAddress tint nth, String value) 
throws TException 



Fig. 5B 



Structurelntertacel] array = getArrayt "/ADDRESS" ) ; 
array(nth] . setField ( "/" , value) ; 
) 

public void setGradePointAverage (String value) 

throws TException 

{ 
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set Field ("/GRADE- POINT-AVERAGE", value) ; 
} 

public voad setHousing ( St ring value) 
throws TException 
{ 

set Fi eld { V BALANCES/ HOUSING" , va lue ) ; 
} 

public void setldNumber (String value) 
throws TException 
\ 

setField ("/ID-NUMBER", value) ; 

) 

public void setName (String value) 
throws TException 

{ 

set Field { " /NAME" , val ue ) ; 
} 

public void setPhoneNumber (String value) 
throws TException 
I 

setFi eld ( " / PHONE ~ NUMBER" , value ] ; 
} 

public void setPIN{ String value) 
throws TException 
< 

setField ("/PIN" , value) ; 

) 

public void setSocialSecurityNumber (String value) 
throws TException 
{ 

setField ( "/SOCIAL- SECURITY -NUMBER" , value ) ; 

) 

public void setTuitionlStnng value) 
throws TException 
I 

setField ("/ BALANCES /TUITION", value ) ; 
) 




6 
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/•» ~ Published APIs and data type? */ 

typeaef long lxsHandle; 

lxsHandle IxsOpenlchar *ic, char *host, 
unsignea short port); 
ir/ lxsCloset lxsHandle handle); 

jr.* lxsfcead{ lxsHandle handle, char 'name, void *aata, unsigned long length); 

in* lxsWritellxsHandie handle, char *name, void 'asts, unsigned long length), 

in* IxsComrnit {lxsHandle handle); 

ir.i lxsKollback (lxsHandle handle); 

vck IxsGetLastNamehead (lxsHandle handle, char *name), 



Fig. 1 0 
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pacKage com. touchnet , util . base ; 

//*** <copynght>* * **•• **»'»***^ ******* + **** + ** + + + * + + ***** + •• 

//* 

//* Copyright (c) 200C 

//* TouchNet Information Systems, Inc. 

//* All Rights Reservec 

//* 

//* This procrem as an unpublishea copyright work of TouchNet Information 
//* Sysiemt, Inc. of Lenexa, KJ . The program, al) anlormation disclosec 
//* ana the matter shown anc cescnbec hereon or herewith are confiaential 
//• ana proprietary tc TouchNet Information Systems, Int. 
//' 

// + **<; CO pyright>* **************************'*********** ********* **************** 
//* 

//* Change Loc. 

//* $Loc: EinaryRenaenngEngine .j ava i 
if* hevision 1.4 2000/07/19 10:36:36 air 
//* 

import com. touchnet -util .base. * ; 
import com. touchnet. util.*; 
import 3 ava .math . Biglnteger ; 
/** 

* This is a utility object that will manage the bit/byte manipulation 

* ior a variety of data conversions 
*/ 

public class BmaryRendermgEngin* 
< 

/** 

* Construct an object that will renoer byte arrays in a variety 

* of format* 

*/ 

public BinaryKenderingEngine ( ! 

super ( ) ; 

1 

/** 

* Access the value that is usee when there is a rendering error 

* ^return bytf 
public byte getErrorByt e ( \ 

return errorByte; 

/** 

* Return a copy oi one of thest. 
* 

* fereturn COM. touchnet .xmlhost . BinaryhenaenngEncinf 
*/ 

public static BinaryKenaeringEngme getl nstance { : 

if (instance -= null' 

instance = new BinaryRenaeringEngine ( ) ; 
return instance; 

/** 

* This is called when there is a iormatting exception such as t 

* string representation of a number that overflows the number ci 

* bytes that number can handle 

* (sparam aata byte[l 

* (sparam exception } ava . 1 ana . NumberFormatExceptior, 
*/ 

public void handl e Format Except ion (byte [ ] oats, II 1 egslArgumentException exception) 

// For now, we just set the bytes to some pre-defanea valut. We may wan; 
// to make this a Java&ean that fires an formatting exception event tc 
// the listeners.. 



Fig. 13A 
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byte err ~ gettrrorByte ( ) ; 

tor (int i = 0; : < data . length; ++i ; 

data[il = en; 
return; 

/** 

* This will parse the string into a lone 

* Creation aate: (7/12/00 11:21:5*? AM 

* & ret urn lone 

* fcpsram number }ava . 1 ana . Stranc 
*/ 

private long parseLong (Strang number 

if I 0 == number .length ( ) 
return C; 

// The Java parseLong() is pretty stupic. It can't handle a leadinc '+', so 3 neec 
// an explicit check tor thai . 

if ('+' — number .char At (0) * 

number - number . substri ng (1 ) ; 

return Long. parseLong {number ) ; 
) 

/*♦ 

* henaer a Java String from e series of bytes with 7-bit ASCII valuef 

* Greturn "java . lang. String 

* feparam aatum byte[j 
*/ 

public String renderAsciiStrmg [byt e [ ) datum; 

int size = datum. length; 
char[) array «= new char(size); 
lor (int i =» 0; l < size; +-H > 

arraylij ■ (char ) renaerPrintabl eAscii (datum(i ) , 1 '); 

return String. valueOf (array) ; 

\ 

/*' 

* This wall return a byte array containing 7-bit ASCII values oeneratec 
+ from the number passec 

* ("return byt e [ ; 

* feparam value am 

* feparam size int 

* feparam pad chaj 
*/ 

public byte[] renaerAsciiStringdnt value, int size, char pac ' 

byte[ buffe* - new bytelsizej; 
im offset * 0; 

boolean negative « false; 

if ((value < 0} && (pec ' ? }, 

value = 0 - value, 
negative « true- 
buffer (of fset++ ) = (byte)*-'; 

i 



Fig. 13B 



String string = Integer .toString (value) ; 

int length - string .1 ength ( J ; 

lor (; offset < size - length; ++offset! 

buffer (of f set] = (byte)pac; // Pad on left if neeaec 

byte [] stringBytes = string. get Bytes ( J ; 
tor (int i «= 0; offset < size; ++offset, +4i) 
buff er (of f set] - stringBytes [ i ) ; 



02/18/2004, EAST Version: 1.4.1 



Patent Application Publication Sep. 27, 2001 Sheet 19 of 23 US 2001/0025372 Al 



return buf f ei ; 
t 

/*- 

* Thif will rencer the two bytes in the array into ar 

* integer anc return the Strang renoennc of the; 

* fereturn y ava . 1 anc . St rinc 

* fcparam raw byte I 
*/ 

public String renoerBi aEndi anl 6Bit (byt e [ ] raw 

short fcyteO = ( short ) raw( Oj ; // Allow this tc sign-extenc 
short byte! - ( short ){ raw [ 1 ] & OxOOFF) ; 

short valu^- * 

(short) ( (byteO << £• 
byt e 1 

}; 

return String .valueOf (value J ; 

* This wili renaer the string numeric into two byte: 

* (sparam 3 ava . 1 anc . St ring 

* ^return raw byte I 
+ / 

public byte[] rencerBigEndianl6Bit (String aatum, 
i 

byte[] raw - new byte [2 J; 

short value = 0; 

try 

1 

value ^ parseShort (datum) ; 

raw[0] = (byte )( (value & OxOOOOFFOO) » 6), 
raw(ll = (byte)( value & OxOOOOOOFFI, 

J 

cat ch( Number Format Exception except 1 on 

{ 

handl eFormat Lxcepti on (raw, exception) , 

\ 



return raw; 



Fig. 13C 



* This will take a series of bytes which are expected tc b* 

* ASCII characters representing numbers, For example: 

{ '-\ '€', '9', 'C - 



* would be -696C. It will return an in; 

* ^return in: 

* fcparam raw byte[; 
*/ 

public mt renaerlnt eaer FromAsciiByt es (byte ( J raw 
i 

String number - renoerAsciiZString (raw) . trin>( ) , 

if ("".equals (number ) ) // All white space is considered a valic 2ero mtegei 
return 0; 

ant value = 0; 
try 

< 
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value- = parselnt (number ) ; 
i 

catch (NumberFormatException exception! 

hand! e FormatLxcept i on (raw, new NumberFormatExcept ion ( ) ; ; 
return -1; 



/*• 

* This will renaer bytes representing a packed aecimal field intc 

* a string representation. This is a helper routine that work; 

* for both signec ana unsigned packed values 

* ^return oava . lang. Stnnc 

* fcparam raw byte I; 

* fcparam isSigned boolean 
V 

private String render Packed (byte [ ] raw, boolean isSigned, ant oflset) 
( 

char signCharacter »• ' • ; // Assume no sign 

StnngBuffer buffe: « new Str mgBuf 1 er ( ) ; 

boolean manuf = false; 

// Take a peek at the offset compared to the length of the rav data and set 
// where the decimal point goes. . 

int appenc - C; 

int msertAfter «= -1; 

ant digits = (raw. length « 1) - 1; 

if (offset > 0) // Append only 
append = oflset; 

else 

{ 

II We have a negative offset, the aecimal will either be to the left oj 
// somewhere an the middlt. 

msertAfter = cagits 4 offset; // Add because offset is neaativf 
if (msertAfter < 0) // The offset means only leading zeros!.. 

buffer. append ( ' . ' ) ; 

for (int i - ineertAf ter; a < 0; -wi 
bu f f er . append ( ' 0 * } ; 

} 

} // els* 

am rlnaex * -l; // Inaex into the raw aata 

ant nibblf = 0; 

boolean secondNibble - true, 

for (int a e 0; a < diaits; +4i! 

i 

if (secondNibble) // Bump input byte every other nibbl* 

++rlndex; 
secondNibble » ! secondNibble ; 

// Wait tor the interataon an which we have to stuff the extra aecimel 
// point . 

if ti ~~ msertAfter) 

buf f er. append ( * . 1 J ; 
if (secondNibble) 

nibble <= raw(rlndex) & OxOOOOOOOF; 



Fig. 13D 
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elst 

nibble = (raw(rlnoex] » 4) i OxOOOOOOOE; 

swi t ch ( ni bbl e ; 

j 

case C: buf i er . append {• 0 1 ) ; break; 
case 1: butter . append (* 1 1 } ; breax; 
case 2: buf fer .append (' 2 '} ; breax; 
case 3: buf ler . append (• 3 ') ; break; 
case 4: buf f er . append (' A * ) ; breaK; 
case b: buf ler . append (' 5 1 ) ; break; 
case e: buf ler . append (' 6 '} ; break; 
case buf i er . append ( 1 7 '} ; breaK; 
case 8: buf ler . append ( 1 6 1 ) ; break; 
case 9: buf ler . append (' S M ; break, 
default : 

hand] e Format Except ion (raw, 

new 113 eaa 1 Argument Except i on ( *' 3 nval id value in data*')] 

return "[data format error)"; 
} // switch 
} // foi 

// Now handle the last nibble which is the sign. 

nibble * raw[rlndex] & OxOOOOOOOf; 
switch (nibble ) 
{ 

case OxOA: 
case OxOC: 
case OxOE: 
case OxOF: 

break; 
case OxOC: 
case OxOfc: 

minus = true; 

break ; 
default : 

( 

handleFormatException ( raw, 

new II lecalAraumentExceptionl "Invalid value in data")); 
return "[data format error)"; 

} 

/ 

// Appenc any aod^tiona) trailing zeros that are a result of the aecimal shifi 
// in the type oescnpto: 

for (int i = 0; : < appenc; ++i; 
buf fer. append ( ' 0' ) ; 

String rencerec = buf f er . toString ( ) , 
if (isSigned minus. 

render ea - '-'4 renaerec; 
return rcnoereo; 

i 

* This is a helper method that wili renaer PIC templates that have been pre-aet ermi nec 

* tc be numeric. It will handle both EBCDIC or ASCII input numerics.. 

* fereturn byte ( ] 

* feparam raw }ava .lang.Strinc 

* feparam template byte[; 

* feparam offset im 

* feparam isAscii boolean 
V 

private byte[] renaerPacked (String raw, mt size, int offset, boolean isSigned; 
byteC buffer * new byte[size), 

ant shif: = 0; // This is the aecimal place shift that we find in the 

// aata. It is used to reconcile the offset parrr 
boolean decima] = false; // ... until we hit a decimal point, then it ie truf 
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boolear. nunu; = false; 

byte() useraats - raw.getBytes () ; 

byte |] numeric . new byte I useraats . 1 ength) ; // j ust the numeric part of the aatc 
numSaze 0; // Count of just the numerics an the user date 



int 



lor lint i = 0; i < useraata . 1 ength; + + i ; 
swatch(useraata [a } ; 

case (byte) *0' 

case (byte) '1 • 

case (byte) »? • 

case (byte) * 3' 

case (byte) • 4 * 

case (byte) '5» 

case (byte) '6' 

case (byte) * 7 ' 

case (byte) '8' 

case (byte) 1 9' 

numen c (numSi ze-n ] = iuserdata 

if (decimal) ++shift; 

break; 



case (byte) 1 : 

minus true; 

break; 
case (byte) ■ + ' ; 

break; 
case (byte) 1 . ' : 

decimal - true; 

break; 
) // switch 
) // toi 



// Now we have the digits separated from the sian and decimal point. Now 
// we have to normalize the oecimal offset and the digit count with the 
// template. What makes this additionally complex is the observation that 
// there can be truncation on either side of the user data if the shift 
// overflows the template, Consiaer the following examples: 

// Assume: 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 
// 

// At this point in the coct, we have the user data filtereo out 
// into a the string -123- . We need to align the oecimal point 
// logically based on the shifts m the template minus the logica' 
shifts from the explicit oecimal point in the cats. 



template ■ 


99999 with shift -2 


Userdats 


An e we j 




123C 


2300C 


(truncation 


123 


1230C 




12.3 


0123C 




1 .23 


00123 




.123 


00012 


(truncation 



am inaex = numSize - ((size « 1) - l) - offset - shift; 
int[J value a new int [2]; 
for (int 1 * 0; l < size-1; + + i; 
{ 

for (int l = 0; 3 < 2; ++3 ; 
( 

af (index < 0J 
value [j] » 0; 

else 

if (index < nurnSize] 

value [j] = numeric (index] & OxOOOOOOOF; 

else 

value [j] - 0; 
++ index; 



Fig. 13F 
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) 

buffex[i] = (byte) ( (value[0) << 4) | valued}}; 

i 

// Do the last byte as a special case since it contains the sign nibble 

lor tint i ~ 0; i < 2; +43 ) 

\ 

if (index < 0, 

value [3] = 0; 

els< 

if (maex < numSize; 

valued] = numeric [index] 4 OxOOOOOOOF; 

el sf 

value[}] = 0; 
++inaex ; 
i 

int sign = OxOC; // Plu: 
if (isSigned £6 minus I 
sign = OxOD; 

buf f er [size-1] = (byte ) ((value [ 0] « 4) I sign}; 

return buffer; 

) 
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METHOD OF ACCESSING DATA AND LOGIC ON 

EXISTING SYSTEMS THROUGH DYNAMIC 
CONSTRUCTION OF SOFTWARE COMPONENTS 

CROSS REFERENCE TO RELATED 
APPLICATIONS 

[0001] This application is a contimiation-in-part applica- 
tion of currently pending applications Ser. No. 09/385,903 
filed Aug. 30, 1999. 

BACKGROUND OF THE INVENTION 

[0002] The present invention relates generally to the field 
of computer software development tools. It relates in par- 
ticular to the generation of executable software components 
based on existing structured data in non-component-based 
languages to access the contents of the structured data at 
runtime. 

[0003] Much of the new software development projects 
are moving to object-oriented development environments 
from the existing procedural, structured development envi- 
ronments. More progressive development environments also 
exploit the use of component-based design, which is an 
extension of object-oriented programming techniques. 
Developers have confirmed what computer science pre- 
dicted a couple of decades ago — namely that object-oriented 
and component-based design yields more maintainable and 
reusable code. Given the complexity of modern network- 
based or "e -Business" applications, there is a strong desire 
among businesses to utilize modern development languages 
and techniques to manage the complexity. 

[0004] One of the most popular programming languages 
for the development of network-centric applications is 
Java®. Java, developed by Sun Microsystems, is an object- 
oriented, multithreaded, platform independent programming 
language. The design of the language, coupled with the rich 
set of available class libraries along with the specification of 
a component model, called JavaBeans®, within the lan- 
guage make it well-suited to develop applications that 
interact with other business applications or customers via the 
World Wide Web. 

[0005] One component framework built by Sun Microsys- 
tems for the Java environment is the JavaServer Pages 
("JSF') framework. A JSP document contains a mixture of 
a text -based markup language (usually HTML but it can also 
be an XML-derived grammar) with small segments of Java 
code and JSP-specific tags. This all-text document is 
dynamically translated into Java source code and compiled 
dynamically into a Java binary file that is suitable for 
execution within a Java Virtual Machine environment. At 
present, JSPs are used primarily as a technique to separate 
the business logic in server-based Java applications ("serv- 
lets") from the presentation of the data to a web browser in 
HTML. 

[0006] As companies create a presence on the Internet for 
business-to-business transactions and business-to-customer 
transactions ("web transactions"), there is a strong desire to 
use the design methodologies and language support for 
object -orientation and component based design. However, 
most of the application logic and data that are required to 
complete a web transaction are contained within existing 
procedural code. This procedural code was developed using 



languages such as COBOL and PL/I that are poorly-suited to 
network-based programming inherent in building web trans- 
actions. Furthermore, this business-critical procedural code 
was developed and is maintained by programmers who, by 
and large, do not have the skills in object-oriented design 
and development and component-based software architec- 
tures. Even for companies that have strong programmer 
skills in modern programming languages and software 
development techniques, there are substantial barriers in 
facilitating web transactions from an existing procedural 
code base. It is inherently cost-prohibitive to recreate the 
business applications in an object-oriented programming 
language such as Java. Even if the funding could be justified, 
the time-to-market is too long to meet business goals. Most 
companies have recently completed reinvesting in their 
existing procedural code base to ensure that it is compliant 
for date processing in the year 2000 ("Y2K compliant'*). 
This indicates a strong willingness by corporations to con- 
tinue to gain benefit from the existing base of code instead 
of simply replacing it. 

[0007] Companies wanting to engage in e-Business face 
two conflicting desires. The first is the desire to manage 
software complexity inherent in web transactions with mod- 
ern object and component-based programming languages. 
The second is the desire to continue to leverage business 
logic and data found in the existing applications developed 
with procedural programming languages and techniques. 

[0008] One popular technique to bridge existing systems 
and new systems is the use of the Extended High-Level 
Language Application Programming Interface ("EHLLAPI" 
or "screen scraping"). The term "screen scraping" is indica- 
tive of how the solution operates. Applications are devel- 
oped, presumably using modern development languages, to 
mimic the behavior of a human terminal user. The software 
reads ("scrapes") the textual information from the terminal 
display and interprets the data much as a human would. 
Similarly, feedback is provided to the existing system by the 
new application simulating the entry of keystrokes by a 
human. This simulation of human terminal interaction with 
software is problematic. The nature of such applications is 
highly process-oriented, and at first glance, would appear to 
be easily automated in software. However, humans are 
vastly more capable of intelligent screen navigation than is 
present software. Humans are also able to recognize out-of- 
context situations, such as error screens or indications that 
the host computer is unavailable. The design of screen 
navigation logic and error detection and recovery logic is 
often as complicated as the network programming and 
complexities of web transactions that the solution was trying 
to avoid. The screen scraping solution often runs into 
problems of scalability and performance. The conventional 
or legacy software systems were designed to interact with 
dozens or perhaps hundreds of corporate terminal users. 
When these legacy software systems become the conduit for 
thousands or millions of Internet users, the architecture often 
fails to scale to meet the demand. 

[0009] Another technique to bridge between web transac- 
tions and existing systems is to access the persistent data 
directly. Such a bridge is described in U.S. Pat. No. 6,081, 
808 (IBM patent) wherein the data from the legacy system 
is directly accessed, but the business logic of the legacy 
application is not applied. While workable solutions exist for 
accessing databases from client/server of network-centric 
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applications, this technique completely bypasses the busi- 
ness rules that apply to the raw data. Most data processing 
systems of any complexity are more than the presentation of 
stored data. They use software applications to manipulate 
the data into usable information. Therefore, a great need 
exists for a method of accessing and incorporating the 
complexity of legacy processing system applications with 
the accessing of the legacy data while dynamically manipu- 
lating that legacy logic and data for use on present day 
object-oriented environments. 

[0010] Other solutions to bridging the gap between mod- 
ern multi-tier object-oriented network-centric applications 
and the existing procedural legacy applications exist in 
middleware products such as IBM's® MQSeries or the 
distributed features in IBM's CICS product. Even with these 
middleware products, there is a need for programmers to 
understand the differences in the underlying binary data 
formats of the legacy computing platform and the architec- 
ture of the platforms on which the object-oriented systems 
run. When data is passed between platforms, data conver- 
sion must be programmed to account for the architectural 
differences. For example, for each field in each record that 
is a text field, such as a person's name, if the source 
information comes from an IBM S/390 mainframe system, 
each letter will have to be converted from the internal 
mainframe EBCDIC encoding to the Java Unicode encoding 
for alphabetic letters. There is also an issue with the ordering 
of bytes in different computer architectures. For example, 
the number 6,091,960 is represented on an Intel Pentium® 
machine architecture as the hexadecimal number B8F45C00 
whereas the same number on an IBM S/390 mainframe is 
represented internally as 005CF4B8. (Note that the ordering 
of the hexadecimal pairs of digits are backward with respect 
to each other). The code to translate all of the internal data 
type representations is error-prone due to the need for 
programmers to understand all of the machine architectures 
they will encounter and the low, bit-level manipulation that 
is required for many of the translations. The present inven- 
tion provides a unique solution to the problem of bridging 
web transactions to existing applications. 

SUMMARY OF THE INVENTION 

[0011] An objective of this invention is to dynamically 
construct a software component from the contents of the 
binary data contained within a running procedural applica- 
tion on an existing system. The resulting software compo- 
nent is able to be programmed using modern object-oriented 
and component-based languages and processes to facilitate 
the development of systems to be used, for example, for 
e-Commerce. 

[0012] Another objective of this invention is to transition 
between procedural skills and languages into object and 
component-based languages in order to leverage the skills of 
two important, but disparate, groups of programmers present 
within most corporate environments. Procedural program- 
ming began to emerge as the programming technique of 
choice in the late 1960's and early 1970's and still represents 
a large percentage of the programming skills in the market- 
place. Procedural code and the way that it typically interacts 
with the data — in the form of record-oriented input and 
output — represents the bulk of the software currently in 
production. The businesses have encapsulated the algo- 
rithms and processes, called "business rules", in the form of 



this procedural software. The result of this invention is to 
facilitate the reuse of existing procedural code that repre- 
sents a corporation's business rules, and possibly their 
competitive advantage in the marketplace, and integrate that 
valuable resource into modern web transactions that are 
developed using object-oriented and component-based 
development techniques. 

[0013] The present invention is comprised of three pri- 
mary application frameworks. The first framework ("work- 
bench") takes source record layout definitions in the pro- 
gramming language in which they were originally developed 
and generates a language-neutral and machine architecture- 
neutral representation of the structure and fields within that 
record layout. For example a COBOL copybook, a Pascal 
record or a PL/I record definition is copied from the existing 
application by the programmer using commonly-available 
text editing software such as ISPF/PDF on a mainframe 
system or vi on a Unix system to the system hosting the 
workbench framework. The programmer uses the work- 
bench software that is part of the present invention to pass 
that textual source code to a lexical analyzer and parser that 
is part of the workbench framework of the present invention. 
The workbench will generate a language-neutral represen- 
tation of the fields within the record layout along with the 
structural context of the fields. The structural context means 
the hierarchical structure within the record, for example that 
the fields are contained within a homogeneous array of fields 
or that the fields are part of a collection of heterogeneous 
fields in a substructure of the whole record structure. This 
part of the present invention creates the data about the data 
in the copybook ("metadata"). The metadata is saved in a 
repository on some persistent storage medium such as a 
database or within a file system. FIG. 8 demonstrates the 
flow of information between the existing source code for an 
application and the workbench. This process is a one-time 
preparatory step and is "offline" with respect to the appli- 
cation as it runs as illustrated in FIG. 11. 

[0014] The second application framework is a program- 
ming interface for the legacy application to communicate 
with the runtime environment. This is comprised of a set of 
program subroutine calls ("Application Programming Inter- 
faces" or "APIs") that implement an open/close/read/write 
metaphor. This programming metaphor, demonstrated in 
FIG. 9, is typical of procedural programming. There is an 
implementation of the API set that is part of the present 
invention for each programming language. Examples 
include, but are not limited to, COBOL, COBOL under 
CICS, PL/I, Pascal, or C. FIG. 10 shows the implementation 
of the programming interface in the C programming lan- 
guage. This framework of the present invention is respon- 
sible for delivering two pieces of information to the com- 
ponent runtime framework of the present invention. 1) The 
name of or numeric reference to the record layout, which is 
used to identify the metadata created by the workbench, and 
2) a reference to the binary data contained within the record 
layout at the time the programming call to read or write data. 
The reference to the binary data is most likely a memory 
address (a "pointer") as implemented in most programming 
languages. The implementation of the APIs includes calls to 
an underlying interprocess communications mechanism 
such as FIFOs in the Unix operating system or named pipes 
in personal computing operating systems such as Windows 
NT or OS/2. The interprocess communications mechanism 
can also be an inter-machine networking protocol such as 
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TCP/IP sockets or APPC over SNA networks. The specific 
implementation is hidden via a programming abstraction 
from the legacy applications programmer utilizing the API 
framework. This second application framework is co-lo- 
cated on the same computer platform as the customer's 
existing procedural code. As a result, it is designed to be a 
minimal implementation of programming logic and essen- 
tially becomes a bridge between the customer code and the 
sophisticated processing and complexity inherent in the third 
application framework described below. 

[0015] The third application framework of the present 
invention is the "component runtime environment". While 
the legacy application is running, it will have been pro- 
grammed to either read or to write a record using the APIs 
that are part of the present invention and are described above 
(an example of which appears as FIG. 10). The process of 
reading or writing a record from the legacy application 
perspective is conceptually the same, but the implementa- 
tion is different, so tbey are discussed separately. When the 
host writes a record using the APIs supplied by the present 
invention, the runtime environment component creates a 
new instance of the component identified for this record. The 
binary contents from the legacy application are loaded into 
the software component. This automates the process that 
would otherwise be tedious and error-prone programming to 
translate the bit patterns appropriate for source platform into 
the bit patterns appropriate for the destination platform. The 
component is now suitable for object-oriented programming 
by applications that utilize the present invention to gain 
access to dynamic data that may have been created by a 
combination of persistent data and business logic within a 
legacy application. 

[0016] The process of the legacy application reading the 
data from the component of the present invention is similar. 
The legacy application reads a record using the APIs sup- 
plied by the present invention (for example using the Ixs- 
Read( . . . ) example from FIG. 10. The API will identify the 
record to be read from the runtime environment. The API 
call pauses execution of the legacy application until the 
binary contents have been loaded into the memory reference 
of the legacy application. The runtime environment frame- 
work will create a new instance of the component identified 
by the API and enable it to be populated with information. 
The component is populated using object-oriented program- 
ming techniques by applications that use the present inven- 
tion. When the component is fully populated, the component 
will construct a binary data layout suitable for the architec- 
ture and programming language of the legacy application 
and present the binary data record to the legacy application 
using the interprocess communications mechanism imple- 
mented within the present invention. When the binary data 
is presented to the API framework of the present invention, 
the legacy application will unblock with the contents of the 
data record populated with the values programmed into the 
component. i 

[0017] FIG. 11 represents the high-level relationship 
between these three frameworks. The workbench framework 
is an offline (or non -runtime) process that maps the existing 
data structures from the existing source code into metadata 
that is stored in a repository. The two online frameworks, the 
API and the component runtime environment, interact pro- 
grammatically using the metadata in the repository to bridge 



any architectural differences between the system running the 
procedural code and the system running the object-oriented 
code. 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0018] For a complete understanding of the present inven- 
tion reference should be made to the following detailed 
description in conjunction with the accompanying drawings. 

[0019] FIG. 1 is a block diagram showing a computer 
system on which a legacy application and the runtime 
environment of the present invention reside as well as the 
flow of data between the frameworks. 

[0020] FIG. 2 is a block diagram showing the flow of data 
from the source code representation to an architecture- 
neutral and language neutral representation. 

[0021] FIG. 3 shows a sample legacy record definition in 
the form of a COBOL copybook. 

[0022] FIG. 4 shows the language -neutral representation 
of a legacy record definition that corresponds to the COBOL 
copybook in FIG. 3. 

[0023] FIG. 5 shows the source code in Java for the base 
class for all generated components. 

[0024] FIG. 6 shows sample source code that implements 
the legacy record definition in FIGS. 3 and 4. 

[0025] FIG. 7 shows the Unified Modeling Language 
description of the base class for all generated components 
shown in FIG. 5. 

[0026] FIG. 8 shows the flow of information in and out of 
the workbench frameworks. 

[0027] FIG. 9 shows the flow of a typical procedural 
program and one that specifically interacts with the inven- 
tion. 

[0028] FIG. 10 shows the implementation of a program- 
ming interface to the present invention using the C program- 
ming language. 

[0029] FIG. 11 shows the high-level relationship between 
the three frameworks of the invention (the 'Workbench", the 
"API" and the "Component Runtime Environment") and the 
use of the metadata obtained from the workbench in the 
runtime environment. 

[0030] FIG. 12 shows a block diagram of the computer 
system on which the workbench frameworks reside. 

[0031] FIG. 13 shows a partial listing of the BinaryRen- 
deringEngine class that is used to transform the underlying 
architecture -specific data fields to and from their corre- 
sponding character values. 

DETAILED DESCRIPTION OF THE 
PREFERRED EMBODIMENT 

[0032] As described below, the present invention will be 
carried out on a single computer or by one or more com- 
puters in a computer network. Referring to FIG. 12, the 
computer on which the workbench framework is hosted 
contains a processor 31, memory 33 and an operating system 
32. Thus, for example, the computer used in the present 
invention is a personal computer or workstation that is 
running an Intel or RISC processor running an operating 
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system such as Microsoft Windows NT, IBM OS/2, IBM 
AIX or Sun Microsystems Solaris. The workbench frame- 
work ("workbench") 37, one of three frameworks, utilizes 
existing source record layout definitions 35 as represented 
by a human readable textual description of a record in the 
source code of a computer language. This is stored on a 
persistent medium such as a hard disk drive and manipulated 
via a text editor that is not part of the present invention. An 
existing COBOL copybook, an example of which is shown 
in FIG. 3, or a PL/I record definition in the source code of 
an existing legacy application are examples of a source 
record definition. However, the source languages capable of 
being utilized by the present invention are not limited to 
COBOL or PL/I. The source record definition is processed 
by a lexical analyzer FIG. 2 capable of translating the 
language-specific representation of a record layout into a 
language-neutral and computer- architecture neutral repre- 
sentation of the data layout ("metadata"). This metadata is 
stored on a persistent storage medium 35 of FIG, 12 and 
accessed and managed via the workbench. An example of 
metadata is shown in FIG. 4. This corresponds to the 
COBOL copybook in FIG. 3. The relationship between the 
COBOL copybook and the metadata is isomorphic. The 
<name> tag in the metadata translates directly into the name 
of the variable in the original COBOL copybook. Preferably 
the lexical analyzer implements an LALR(l) grammar, as is 
well-known in the art, but this is not a requirement of the 
present invention. The preferred embodiment of the present 
invention implements this translation to a language-neutral 
representation of the record layout for reasons of portability 
and runtime performance although this translation step is not 
a requirement of the present invention. As a less-preferred 
alternative to the language -neutral representation of the 
metadata would be to simply use the record layout from the 
original source code. However, it is anticipated that the 
performance degradation as a result of this implementation 
would limit the practicality of directly parsing the original- 
language source code at runtime. This would reduce the 
requirements of the code in the workbench to managing a 
repository of source-code definitions instead of managing a 
repository of language-neutral metadata. 

[0033] The application programming interface ("API"), 
the second of three frameworks of the present invention, is 
a language -specific and runtime environment^specific soft- 
ware layer that enables the legacy applications programmer 
working with a specific language within a specific runtime 
environment to access the facilities of the runtime frame- 
work of the present invention. Referring to FIG. 1, the API 
22 represents the programming interface that passes a ref- 
erence (usually via a memory address or "pointer") to the 
binary data within the legacy application to and from the 
interprocess communications layer to utilize services of the 
runtime frameworks of the present invention. An example of 
a programming interface has been built for C programmers 
on an IBM S/390 mainframe system to access the runtime 
services of the present invention. This example is presented 
in FIG. 10. However, this is an example of legacy runtime 
environments supported by the API framework. Other 
implementations for other languages, operating systems and 
runtime environments are also supported by the present 
invention. 

[0034] Referring to FIG. 1, the computer on which the 
legacy application is hosted contains a processor 20, 
memory 21 an operating system 30 and a language runtime 



environment for the programming language in which the 
legacy application is written. Thus, for example, the com- 
puter used in the present invention for hosting the legacy 
application is a server class computer running an Intel, RISC 
or CISC processor running an operating system such as 
Microsoft Windows NT, IBM OS/2, Compaq OpenVMS, 
Sun Microsystems Solaris, IBM AIX, or IBM OS/390. The 
computer on which the component runtime is hosted, con- 
tains also contains a processor 20, memory 21, an operating 
system 30 and a language runtime environment for the 
programming language in which the component runtime 
application is written. The language runtime may be a Java 
Virtual Machine, or a more traditional runtime environment 
that ships with the language compiler under which the 
component was developed, such as the MSVCRT.DLL that 
ships with Microsoft Visual C++. The language runtime is 
used by the present invention but should not be confused 
with the component runtime. Thus, for example, the com- 
puter used in the present invention for hosting the compo- 
nent runtime is a server class computer running an Intel, 
RISC or CISC processor running an operating system such 
as Microsoft Windows NT, IBM OS/2, Compaq OpenVMS, 
Sun Microsystems Solaris, IBM AIX, or IBM OS/390. 

[0035] The legacy application and the component runtime 
may co-exist on the same computer or they may exist on 
separate computers connected by a computer network. Thus, 
referring to FIG. 1, the interprocess communications 23 
may be an interprocess and inter-computer communications 
mechanism implemented as a computer networking proto- 
col. Thus, for example, the legacy application may be 
communicating with the component runtime via an operat- 
ing system-defined serial interprocess communications 
mechanism such as named pipes or FIFOs, or they may 
communicate via a networking protocol such as TCP/IP 
sockets, IBM SNA APPC communications, or asynchronous 
serial communications. 

[0036] The component runtime, the third of three frame- 
works of the present invention, is the most complex of the 
three. The component runtime is responsible for two basic 
operations. The first is the construction of components based 
on a reference to the metadata constructed by the work- 
bench. The second is the population of the contents of that 
component in an architecture-neutral form and the emission 
of the contents of the component in an architecture-specific 
binary form when communicating with the legacy applica- 
tion. These two primary operations of the component runt- 
ime is best understood by describing the sequence of events 
when binary data is to flow from the legacy application to 
the runtime and similarly when binary data flows from the 
runtime to the legacy application. 

[0037] The present invention implements the following 
operational processes to implement data flow from a legacy 
application to the component runtime. Referring to FIG. 1, 
the legacy application is running on a computer processor 
and has constructed a representation of a business datum in 
a manner appropriate for the application using facilities in 
the legacy application source code. The legacy application 
calls the API 22 of the present invention with a reference (or 
"pointer") to the architecture-specific binary data and an 
indication of the name of the record as implemented by the 
API. The API 22, sends the architecture-specific binary data 
and the name of the legacy record to an interprocess com- 
munications mechanism 23. This interprocess communica- 
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tions is typically, but not limited to, a TCP/IP network 
connection. The name of the legacy record is used as a 
reference to the metadata of the legacy record created by the 
workbench. 

[0038] The component runtime then passes the reference 
24 to the metadata to the component factory 25. The 
component factory is part of the software that comprises the 
component runtime. The responsibility of the component 
factory is to dynamically construct the objects that manage 
the data being exchanged between the legacy application 
and the object-oriented systems that interoperate with the 
objects constructed by the component runtime. It imple- 
ments the "Abstract Factory" design pattern as described in 
"Design Patterns. Elements of Reusable Object-Oriented 
Software" by Gamma, et. al. and is well-known to those 
skilled in the art. The component factory determines if an 
object class description exists for the metadata. An example 
of this using a component runtime in Java would be an 
object of type Class. If the class for the object exists, the 
object class is used to construct a new instance of the class 
that can represent the contents of the legacy application's 
binary record. If there is no object class description available 
to the component factory, lie metadata is used by the 
component factory to generate human-readable, textual 
source code in the object-oriented language implemented by 
the component runtime. Thus, for example, if the Java 
language is used as the object-oriented language in which to 
implement the component runtime, then the component 
factory would generate Java source code that is appropriate 
to interpret the contents of the binary data within the legacy 
application's record structure. The source code, in this 
example Java source code, is used as input into a compiler 
implementing the language, in this example, a Java com- 
piler. The compiler will generate a binary class definition 
file. That class definition file is used to construct a new 
instance of the class that is suitable for managing the binary 
data from the legacy record. 

[0039] The next step in the process is for the component 
runtime to pull the data from the interprocess communica- 
tions mechanism 23 and pass the data to the component via 
the data feed 28 that is accessible by the generated compo- 
nent. The component was generated by the component 
factory with the metadata for a specific legacy record layout, 
so there is code generated to accommodate the architecture- 
specific binary data stream. On a datum by datum basis, the 
architecture-specific binary data stream is read by the spe- 
cially-created component and converted to corresponding 
fields within the generated component by a binary rendering 
engine. This includes the transformation of textual informa- 
tion from one character encoding set, for example EBCDIC 
to the character encoding of the component runtime, for 
example Unicode. It also includes the transformation of 
little-endian architecture numbers to big-endian architecture 
numbers using appropriate bit manipulation for that particu- 
lar field. Using the metadata example from FIG. 4, the 
software component would have been specifically con- 
structed to perform the following series of operations, 
assuming that metadata came from a machine on an IBM 
S/390 architecture and the component runtime was written 
in the Java programming language: 

[0040] 1) Read 6 bytes (since the "size" attribute of 
the metadata indicates this is a six-byte field) and 



convert from binary -coded-decimal ("BCD") to an 
integer value. Assign that number to the object field 
named "ID-NUMBER". 

[0041] 2) Read 6 bytes and convert from BCD to an 
integer value. Assign that number to the object field 
named "PIN". 

[0042] 3) Read 35 bytes and convert from EBCDIC 
to Unicode. Assign that character string to the object 
field named "NAME". 

[0043] 4) For each of the three elements in the array: 

[0044] a) Read 25 bytes and convert from 
EBCDIC to Unicode. Assign that string to the 
object field "ADDRESS" within the array in the 
object. 

[0045] 5) Read 12 bytes and convert the values from 
EBCDIC to Unicode. Assign that string to the object 
field named "PHONE-NUMBER". 

[0046] 6) Read 11 bytes and convert the values from 
EBCDIC to Unicode. Assign that string to the object 
field named "SOCIAL-SECURITY-NUMBER". 

[0047] 7) Read 3 bytes and convert those three bytes 
to a float number. Assign that float value to the object 
field named "GRADE-POINT- AVERAGE". 

[0048] 8) Read 3 bytes and convert from a S/390 
packed decimal format to an integer. Assign that 
integer value to the object field named "BAL- 
ANCES/TUITION". 

[0049] 9) Read 3 bytes and convert from a S/390 
packed decimal format to an integer. Assign that 
integer value to the object field named "BAL- 
ANCES/HOUSING". 

[0050] The conversions from one data type to another is 
accomplished via the BinaryRenderingEngine class that is 
part of the component runtime. A partial listing of that class 
in the Java programming language is listed in FIG. 13. 

[0051] The process for sending architecture-specific data 
to the legacy application is similar, but the process starts 
with the object-oriented code. The programmer program- 
ming in the object-oriented language, for example Java, 
requests from the component runtime that an object of a 
specific type is constructed. If the binary class definition file 
exists for that type, a new instance is constructed with empty 
values. If there is no object class description available to the 
component factory, the metadata is used by the component 
factory to generate human-readable, textual source code in 
the object-oriented language implemented by the component 
runtime. Thus, for example, if the Java language is used as 
the object-oriented language in which to implement the 
component runtime, then the component factory would 
generate Java source code that is appropriate to construct an 
appropriate architecture -specific binary data stream to be 
sent back to the legacy application. The object-oriented 
programmer populated the fields within the component with 
values that are applicable to the business problem it was 
designed to solve. When the object-programmer is ready to 
pass the information to the legacy application, it will be 
passed to the component runtime. In the Java component 
runtime example shown in FIG. 5, this process will be 
invoked via the write (Outputs tream)method. Since the 
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component was generated to match a specific legacy record 
definition, its source code was generated to convert the 
values in the component to the architecture-specific binary 
representation using the binary rendering engine using the 
reverse process of steps described in the above 9-step 
example. This binary data is passed through the data feed 28 
to the interprocess communications mechanism 23. The API 
22 unblocks from the legacy application's call to read the 
information with the binary data underlying the reference 
that was given by the API 22 to the legacy record definition. 
The legacy application is insulated from the transformations 
to a different architecture and the manipulations from object- 
oriented code that results from the operation of the compo- 
nent runtime framework of the present invention. 

[0052] Referring to the UML diagram in FIG. 7, each 
component contains a binary rendering engine that is 
responsible for converting the information within the com- 
ponent to and from the architecture-specific binary data used 
by the legacy application. This process is more complex than 
is initially apparent. The first complexity comes from the 
data translation. There are multiple character representa- 
tions, such as single -byte ASCII and EBCDIC and the 
double-byte Unicode, There are also differences in the byte 
ordering ("endian-ness") of binary integer representations 
among processor architectures. For example, the Intel x86 
processor family represents the least significant byte of the 
integer first ("little-endian") whereas most other processor 
architectures such as the Sun SPARC and the IBM S/390 
processor architectures represent the most significant byte 
first ("big-endian"). Finally, not all elementary data types are 
supported on all processor architectures. For example, the 
IBM S/390 processor architecture implements binary coded 
decimal (BCD) data as a basic data type. BCD is not 
supported natively on Intel or most RISC processors. The 
second form of complexity occurs in the way that language 
compilers generate the legacy record definitions. Most com- 
puter processors can perform arithmetic computer opera- 
tions faster if the numbers on which they operate are aligned 
on an even machine word boundary, usually an even mul- 
tiple of two, four or eight bytes. The compiler developers 
will exploit this performance improvement by inserting 
additional bytes ("filler bytes") in the record definition to 
ensure alignment on even boundaries. The generated com- 
ponent accommodates these additional filler bytes in addi- 
tion to the translation of each datum. A partial listing of the 
BinaryRenderingEngine is included in FIG. 13. It reveals 
part of the complexity that the present invention encapsu- 
lates so that applications programmers are not exposed to 
this level of architecture-specific binary representations. 

Having thus described our invention, we claim the following 
to be new and desire to secure by Letters Patent that which 
is set forth in the following claims. We claim: 
1. A method for translating the contents of a binary data 

record existing in a programming language to a component 

in an object-oriented programming system comprising the 

steps of: 



(a) determining a data record layout of a binary data 
record in an architecture-specific program, said data 
record layout comprising a name component and a 
contents component, 

(b) associating a first reference to said name component 
and a second reference to said contents component of 
said data record layout, said first and said second 
references operating as address parameters to allow a 
programming interface to select said name component 
and said contents component from said data record 
layout in response to a data request, 

(c) modifying said architecture-specific program to 
include said first and said second references for use by 
said programming interface, and 

(d) generating source code for a software component of an 
object-oriented programming system, said software 
component being adapted to send to said programming 
interface said data request for the content of said binary 
data record associated with said reference, and said 
software component being adapted to receive from said 
programming interface a response to said data request. 

2. The method as claimed in claim 1 wherein said 
identifying step further comprises translating the source 
code of said architecture-specific program to a language- 
neutral representation including the hierarchical structure of 
said architecture-specific program. 

3. The method as claimed in claim 1 wherein said 
associating step further comprises a published programming 
interface to allow multiple programming languages to con- 
nect with an interprocess communications mechanism to 
deliver said name component of said record layout and an 
architecture-specific binary data record to said software 
component. 

4. The method as claimed in claim 1 wherein said 
modifying step further comprises a base component from 
which generated source code can be derived using object- 
oriented inheritance language constructs. 

5. The method as claimed in claim 2 wherein an archi- 
tecture-specific program source code (having a data ele- 
ment) is parsed to create a language neutral representation of 
said data element where the result of the parsing is stored in 
a persistent storage medium such as a relational database or 
a file system. 

6. The method as claimed in claim 1 whereas wherein said 
generating step further comprises dynamically invoking a 
compiler to convert said source code of said software 
component into a binary form, 

7. The method as claimed in claim 6 further comprising a 
software to load said generated binary form into memory for 
use. 

***** 
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